* ************************************************************************
* File-Name: 	ReadMe.txt
* Date:  	10/24/2019
* Author: 	Meital Rosenberg, Daniel Armanios, Michael Aklin, Paulina Jaramillo
* Purpose: 	explain how to use the replication package for:
*
*	Meital Rosenberg, Daniel Armanios, Michaël Aklin, Paulina Jaramillo.
*	2019. "Evidence of Gender Inequality in Energy Use from a Mixed Methods 
*	Study in India" Nature Sustainability.
*
* Contact:	for questions about replication: michael.aklin@gmail.com.
* ************************************************************************



* ************************************************************************
* 0. Purpose
* ************************************************************************

This ReadMe.txt file explains how to replicate the results of our paper:

Meital Rosenberg, Daniel Armanios, Michaël Aklin, Paulina Jaramillo. 2019. "Evidence of Gender Inequality in Energy Use from a Mixed Methods Study in India" Nature Sustainability.


* ************************************************************************
* 1. List of files
* ************************************************************************

ReadMe.txt: this file.
Rosenberg_et_al_dataprocessing_code.do: Stata file to generate the final dataset.
Rosenberg_et_al_analysis_code.do: Stata file to replicate the main tables and figures.
Rosenberg_et_al_analysis_code.R: R file to recreate the map and the Bayesian analysis.


* ************************************************************************
* 2. Replication
* ************************************************************************

To replicate our findings:

(1) Download the ACCESS-1 data (RawDataHH) available at https://doi.org/10.7910/DVN/0NV9LF. See citations below.

(2) Download this replication package. 

(3) In Rosenberg_et_al_analysis_code.do: update the path to the working directory.

(4) In Rosenberg_et_al_analysis_code.do: run blocks #1 and #2. This will generate the coded dataset needed for the R file by running Rosenberg_et_al_dataprocessing_code.do.

(5) To replicate our main results: run block #3 of Rosenberg_et_al_analysis_code.do. 

(6) To replicate our Bayesian analysis, our map, or our sensitivity analysis: run Rosenberg_et_al_analysis_code.R. Note: to replicate our maps, you will need to download data from IHDS. Please see Rosenberg_et_al_analysis_code.R for more details.


* ************************************************************************
* 3. Citations
* ************************************************************************

To cite this paper: 
Meital Rosenberg, Daniel Armanios, Michaël Aklin, Paulina Jaramillo.2019. "Evidence of Gender Inequality in Energy Use from a Mixed Methods Study in India" Nature Sustainability.

To cite the ACCESS-1 data: 
Aklin, Michaël; Cheng, Chao-yo; Ganesan, Karthik; Jain, Abhishek; Urpelainen, Johannes; Council on Energy, Environment and Water. Access to Clean Cooking Energy and Electricity: Survey of States in India (ACCESS). 2016. Harvard Dataverse, V1. http://dx.doi.org/10.7910/DVN/0NV9LF.

To cite the ACCESS-1 study: 
Aklin, Michaël, Chao-yo Cheng, Johannes Urpelainen, Karthik Ganesan, and Abhishek Jain. 2016. "Factors Affecting Household Satisfaction with Electricity Supply in Rural India." Nature Energy 1(16170). DOI: 10.1038/nenergy.2016.170. (http://www.nature.com/articles/nenergy2016170)





